home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 030 / listuser.arc / LISTUSER.DOC < prev    next >
Text File  |  1986-07-27  |  17KB  |  647 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                    ListUser
  15.  
  16.                                   Version 1.0
  17.  
  18.  
  19.                          Program Documentation Manual
  20.  
  21.  
  22.                                  July 26, 1986
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                              Better Systems Design
  36.                                  P.O. Box 1361
  37.                               Ottumwa, Iowa 52501
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.     Copyright (c) 1986   Better Systems Design
  52.                          All Rights Reserved 
  53.  
  54.  
  55.  
  56.  
  57.                                    COPYRIGHT
  58.  
  59.  
  60.     This  program  is  copyright  (C)  1986  by Better Systems Design.  All 
  61.     rights reserved.  Non-registered users are granted a limited license to 
  62.     use this  product on a trial  basis, and to copy  the program for trial 
  63.     use by others subject to the following limitations.
  64.  
  65.          The  program  is  distributed  in  unmodified  form, complete with 
  66.          documentation.
  67.  
  68.          No fee, charge or other consideration is requested or accepted.
  69.  
  70.          The  program  is  not  distributed  in  conjunction with any other 
  71.          product.
  72.  
  73.     If you intend  to use ListUser on a regular  basis, please register and 
  74.     show your support for this program.
  75.  
  76.     You  must  register  ListUser  for  each  file server you intend to use 
  77.     ListUser on.
  78.  
  79.  
  80.  
  81.  
  82.  
  83.                                   TRADEMARKS
  84.  
  85.     NetWare and Novell are trademarks of Novell, Inc.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.     Copyright (C) 1986   Better Systems Design                           ii
  107.  
  108.  
  109.  
  110.     ListUser 1.0                                                   Contents
  111.  
  112.  
  113.  
  114.     CONTENTS
  115.  
  116.  
  117.     Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  118.  
  119.     How to Use ListUser  . . . . . . . . . . . . . . . . . . . . . . . .  2
  120.  
  121.     Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  122.  
  123.     User Supported Software  . . . . . . . . . . . . . . . . . . . . . .  5
  124.  
  125.     Product Support  . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  126.  
  127.     Author's Notes . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  128.  
  129.     Registration Form  . . . . . . . . . . . . . . . . . . . . . . . . .  9
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.     Copyright (C) 1986   Better Systems Design                          iii
  161.  
  162.  
  163.  
  164.     ListUser 1.0                                               Introduction
  165.  
  166.  
  167.  
  168.                                  INTRODUCTION
  169.  
  170.  
  171.     PROGRAM DESCRIPTION
  172.  
  173.     ListUser is  a program designed  to list the  network users and network 
  174.     user identifications on Novell networks using  Advanced NetWare 1.0 and 
  175.     above. 
  176.  
  177.     The following features are included in ListUser version 1.0:
  178.  
  179.          Lists network users and network user identifications.
  180.  
  181.          List the users to either the screen or printer.
  182.  
  183.  
  184.     MACHINE REQUIREMENTS
  185.  
  186.     ListUser requires 128K  of available RAM.  The  IBM BASICA interpreter.  
  187.     DOS 2.1 or higher.      
  188.  
  189.     ListUser was developed on an IBM-AT  using DOS 3.1, running on a Novell 
  190.     S system network using Advanced NetWare 1.02.
  191.  
  192.     The  program should run on  any IBM or close  compatible that will also 
  193.     run on a Novell Network using Advanced NetWare 1.0 or above.
  194.  
  195.     The program will run on either a monochrome or color display.
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.     Copyright (C) 1986   Better Systems Design                            1
  215.  
  216.  
  217.  
  218.     ListUser 1.0                                        How to Use ListUser
  219.  
  220.  
  221.  
  222.                               HOW TO USE LISTUSER
  223.  
  224.  
  225.     STARTING THE PROGRAM
  226.  
  227.     Four programs are supplied with ListUser:  
  228.  
  229.          RBASNETA.EXE
  230.          LISTUSER.BAS
  231.          LISTUSER.BAT
  232.          LISTUSER.DOC
  233.  
  234.     Start ListUser by typing LISTUSER at the dos prompt.  This will execute 
  235.     the LISTUSER.BAT  batch file.  The contents of the LISTUSER.BAT file is 
  236.     as follows:
  237.  
  238.          RBASNETA
  239.          BASICA LISTUSER
  240.  
  241.     The  first  command  RBASNETA  loads  the  library  routines  needed by 
  242.     ListUser  to  access  the  NetWare  function calls.  The second command 
  243.     loads BASIC and executes the LISTUSER.BAS program.
  244.  
  245.     Once ListUser  has been started the copyright screen will be displayed.  
  246.     Press the ENTER key to continue.
  247.  
  248.     After the  copyright screen has  been displayed the  ListUser selection 
  249.     screen will be displayed.  The screen looks as follows:
  250.  
  251.          DO YOU WANT THE REPORT TO GO TO
  252.  
  253.              SCREEN  (S)
  254.              PRINTER (P)
  255.              QUIT    (Q)
  256.  
  257.          PLEASE ENTER YOUR CHOICE (S/P/Q) -
  258.  
  259.     You have three choices.
  260.  
  261.          SCREEN  - The output will display on the screen.
  262.  
  263.          PRINTER - The output will display on the printer.
  264.  
  265.          QUIT    - Do not display the report and return to DOS.
  266.  
  267.  
  268.     Copyright (C) 1986   Better Systems Design                            2
  269.  
  270.  
  271.  
  272.     ListUser 1.0                                        How to Use ListUser
  273.  
  274.  
  275.  
  276.     Enter - S - if you want the output  to be displayed on the screen.  The 
  277.     user and  identification information will the  be displayed.  After the 
  278.     screen has filled you will  be asked to press the ENTER  key to display 
  279.     the next  page.  After  the last  page has  been displayed  you will be 
  280.     asked to press the ENTER key to return to the operating system.
  281.  
  282.     Enter - P - if you want the output to be displayed on the printer.  The 
  283.     screen will clear and the word PRINTING will be displayed in the center 
  284.     of  the screen.  Under the  word PRINTING a count  will be displayed of 
  285.     how many records have been printed.  The output to the printer normally 
  286.     goes to the local printer.  To send the output to a network printer you 
  287.     must use  the SPOOL and  ENDSPOOL command from  the operating system to 
  288.     redirect the output to the network printer.. 
  289.  
  290.     Enter -  Q - if you decide you do  not want to display the report.  You 
  291.     will be returned to the operating system.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.     Copyright (C) 1986   Better Systems Design                            3
  323.  
  324.  
  325.  
  326.     ListUser 1.0                                               Registration
  327.  
  328.  
  329.  
  330.  
  331.     User  feedback is an  integral part of  any successful software system.  
  332.     Please share  your impression of  ListUser by leaving  a message on the 
  333.     support bulletin board  system with you name, address, occupation, type 
  334.     of  system and any comments or suggestions you care to pass along.  You 
  335.     might also  mention where you  got the program.   Call the Indian Hills 
  336.     Community College BBS at (515)-683-5193.  
  337.  
  338.     ListUser is distributed as User-Supported Software.  I encourage you to 
  339.     try the  program and share it  with others who might  find it of use as 
  340.     long as:
  341.  
  342.          The program is distributed complete  and unchanged, accompanied by 
  343.          the documentation.
  344.  
  345.          No fee, charge or compensation is requested or received.
  346.  
  347.          ListUser is not distributed in conjunction with any other product.
  348.  
  349.     If  you  find  this  program  useful,  please  show   your  support  by 
  350.     registering.  To register send  the registration form found at  the end 
  351.     of this documentation.  There is  no payment required to register  your 
  352.     copy  of  ListUser,  but  a  donation  is requested to the Indian Hills 
  353.     Foundation Scholarship  Fund.  The  Indian Hills  Foundation is  a non-
  354.     profit  organization that gives scholarships  to qualifying students of 
  355.     Indian Hills Community College.  The donation is tax deductible.
  356.  
  357.     To make a donation along with your registration, make the check payable 
  358.     to:
  359.  
  360.          INDIAN HILLS FOUNDATION SCHOLARSHIP FUND
  361.  
  362.     The canceled check will be your receipt.
  363.  
  364.     Registered  users  will  receive  notification  of  major  releases  of 
  365.     ListUser and  of any  new NetWare  utilities that  may be  forthcoming.  
  366.     This does not  mean that there will be any  future releases of ListUser 
  367.     or  any new utilities (your support  will make a difference).  You will 
  368.     also receive priority treatment on the support BBS.
  369.  
  370.     Registered users who donate  20 dollars or more to  the scholarship fund 
  371.     will  also  receive  free  upgrades  by  mail  of any major releases of 
  372.     ListUser for one year from the date that the registration is received. 
  373.  
  374.  
  375.  
  376.     Copyright (C) 1986   Better Systems Design                            4
  377.  
  378.  
  379.  
  380.     ListUser 1.0                                    User Supported Software
  381.  
  382.  
  383.  
  384.                             USER SUPPORTED SOFTWARE
  385.  
  386.  
  387.     User-supported  software  is  a  means  for  the computing community to 
  388.     receive  quality  software  while  directly  supporting   the  software 
  389.     authors.  It is based on the ideas that:
  390.  
  391.          The value and utility  of software is best assessed by the user on 
  392.          his or her own system.   Only after using a program can one really 
  393.          determine  whether  it  serves  personal  applications,  needs and 
  394.          tastes. 
  395.  
  396.          The  creation of  independent personal  computer software  can and 
  397.          should be supported by the computing community.
  398.  
  399.          Copying of programs should be encouraged, rather than  restricted.  
  400.          The   ease  with   which  software   can  be  distributed  outside 
  401.          traditional commercial channels reflects the strength, rather than 
  402.          the weakness, of electronic information.
  403.  
  404.     Under the user-supported concept, anyone may request  a copy of a user-
  405.     supported program  by sending  a blank,  formatted disk  to the program 
  406.     author together with an  addressed, postage-paid return mailer.  A copy 
  407.     of the  program, along with documentation, will  be sent by return mail 
  408.     on the users disk.
  409.  
  410.     The program  carries a notice  suggesting registration of  the program.  
  411.     If the program does not fit your needs, you do not need to register it.
  412.  
  413.     Regardless of  whether you  register, you  are encouraged  to copy  and 
  414.     distribute the program for the private, non-commercial use of others.
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.     Copyright (C) 1986   Better Systems Design                            5
  431.  
  432.  
  433.  
  434.     ListUser 1.0                                            Product Support
  435.  
  436.  
  437.  
  438.                                 PRODUCT SUPPORT
  439.  
  440.      
  441.     In order to support  users, and to provide  a means of distribution,  I 
  442.     have  implemented  a  special  conference  for  registered users on the 
  443.     Indian Hills Community College  BBS.  If you have questions or comments 
  444.     just call and  leave a message.  If you have  a problem leave a message 
  445.     describing  as completely as possible the  problem you are having, your 
  446.     system configuration and program version.  Describe what steps you take 
  447.     before the problem  occurs, and exactly  what the program  does when it 
  448.     occurs.   If you do  not provide a  complete description of the problem 
  449.     there is little  I can do to fix it.  I will do my best to help, but if 
  450.     you are not a registered user I do  not guarantee to provide support of 
  451.     any kind.
  452.  
  453.     You  will  always  find  the  latest  version of ListUser and any other 
  454.     NetWare utilities on the Indian Hills Community College BBS.  The phone 
  455.     number  for  the  board  is  (515)-683-5193.   The board is normally in 
  456.     operation 24 hours per day.  It is running PCBoard software.
  457.  
  458.     ListUtil may also be found on various other bulletin boards.
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.     Copyright (C) 1986   Better Systems Design                            6
  485.  
  486.  
  487.  
  488.     ListUser 1.0                                             Author's Notes
  489.  
  490.  
  491.  
  492.                                 AUTHOR'S NOTES
  493.  
  494.              
  495.     HISTORY
  496.  
  497.     I  developed ListUser for use on the Novell Networks that are in use by 
  498.     Indian Hills Community College.  I am a computer programming instructor 
  499.     for  IHCC  (Better  Systems  Design  is  a  part  time  programming and 
  500.     consulting business).  I have responsibilities that include maintaining 
  501.     the  networks.   IHCC  has  approximately  250  users  defined  on  the 
  502.     networks,  most of these  are students.  Five  sections of students are 
  503.     started  each  year,  each  section  may  have  up to 35 students.  The 
  504.     students are in  the computer programming  course for 18  months.  This 
  505.     should indicate to you that we have a lot  of user maintenance.  In the 
  506.     past we  had to maintain our user list with  pen and paper, now we have 
  507.     made the job a little easier. 
  508.  
  509.     ListUser 1.0
  510.  
  511.     Released  July  26,  1986.   This  is  a  brand  new program written in 
  512.     interpreted BASIC.  The program is saved in protected mode, this not to 
  513.     protect the source code (if you  call most any BBS there are  unprotect 
  514.     programs  available).  Because  this is  an initial  release the source 
  515.     code can still stand some cleaning  up, and it is a little difficult to 
  516.     read and follow.  Also, because it uses Advanced NetWare function calls 
  517.     a person  can get themselves in  trouble if they do  not know what they 
  518.     are doing (do  you want to re-sysgen  your network?).  That is  why the 
  519.     source is saved in protected mode. 
  520.  
  521.     
  522.     FUTURE
  523.  
  524.     I plan  to add  other functions  to ListUser  such as  output to a disk 
  525.     file.   If  you  have  any  suggestions  that  you  think would improve 
  526.     ListUser I would like to hear  them.  Also, if you have any  suggestion 
  527.     for other NetWare utilities, please let me know.
  528.      
  529.     I do plan on compiling the next major release  (2.0) of ListUser.  This 
  530.     will speed the program considerably.  I may even rewrite the program in 
  531.     Pascal.
  532.  
  533.     
  534.  
  535.  
  536.  
  537.  
  538.     Copyright (C) 1986   Better Systems Design                            7
  539.  
  540.  
  541.  
  542.     ListUser 1.0                                             Author's Notes
  543.  
  544.  
  545.  
  546.  
  547.     OTHER
  548.  
  549.     If your company  or any other company  you know of need  any good entry 
  550.     level  programmers,   we  would  like  to  here  from  you.   For  more 
  551.     information  concerning  Indian  Hills  or  our  programming   students 
  552.     contact: 
  553.  
  554.          Rick Northup
  555.          Indian Hills Community College
  556.          Grandview & Elm
  557.          Ottumwa, Iowa  52501
  558.  
  559.     Rick is  a Lead  Instructor who  works with  our students on placement.  
  560.     You can also call him at (515)-683-5206.  Indian Hills is on a four day 
  561.     week so if you call make it between 7:30 and 4:30 Monday thru Thursday.
  562.  
  563.     I can be contacted by mail at:
  564.      
  565.          Bill Bagley
  566.          Indian Hills Community College
  567.          Grandview & Elm
  568.          Ottumwa, Iowa  52501
  569.  
  570.               or
  571.  
  572.          Bill Bagley
  573.          Better Systems Design
  574.          P.O. Box 1361
  575.          Ottumwa, Iowa  52501
  576.  
  577.               or
  578.  
  579.          Indian Hills Community College BBS
  580.          (515)-683-5193
  581.          (I am the SYSOP)
  582.  
  583.     I have the same office hours as above.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.     Copyright (C) 1986   Better Systems Design                            8
  593.  
  594.  
  595.  
  596.     ListUser 1.0                                          Registration Form
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.     Send To:                      Bill Bagley                  Registration
  604.                              Better Systems Design
  605.                                  P.O. Box 1361
  606.                              Ottumwa, Iowa  52501
  607.  
  608.     Make donation
  609.     payable to:    Indian Hills Foundation Scholarship Fund
  610.  
  611.  
  612.  
  613.  
  614.     Name:     ____________________________________________________________
  615.  
  616.     Company:  ____________________________________________________________
  617.  
  618.     Address:  ____________________________________________________________
  619.  
  620.               ____________________________________________________________
  621.  
  622.     City:     ______________________   State:  _________   Zip:  _________
  623.  
  624.     ======================================================================
  625.     Date:                              PO#
  626.     ======================================================================
  627.                                                 Donation
  628.     Quantity   Description                      per copy       Extended
  629.     ----------------------------------------------------------------------
  630.              |                              |              |  
  631.              | ListUser Version 1.0         | $            | $
  632.              |                              |              |
  633.     ----------------------------------------------------------------------
  634.  
  635.     Comments: ____________________________________________________________
  636.  
  637.               ____________________________________________________________
  638.  
  639.               ____________________________________________________________
  640.  
  641.               ____________________________________________________________
  642.  
  643.               ____________________________________________________________
  644.  
  645.  
  646.     Copyright (C) 1986   Better Systems Design                            9
  647.